package com.nanhai.buddhist.college.module.collegebase.service.studentchangelog;

import java.util.*;
import javax.validation.*;

import com.nanhai.buddhist.college.module.collegebase.controller.admin.studentchangelog.vo.StudentChangeLogCreateReqVO;
import com.nanhai.buddhist.college.module.collegebase.controller.admin.studentchangelog.vo.StudentChangeLogExportReqVO;
import com.nanhai.buddhist.college.module.collegebase.controller.admin.studentchangelog.vo.StudentChangeLogPageReqVO;
import com.nanhai.buddhist.college.module.collegebase.controller.admin.studentchangelog.vo.StudentChangeLogUpdateReqVO;
import com.nanhai.buddhist.college.module.collegebase.dal.dataobject.studentchangelog.StudentChangeLogDO;
import com.nanhai.buddhist.college.module.collegebase.controller.admin.studentchangelog.vo.*;
import com.nanhai.buddhist.college.framework.common.pojo.PageResult;

/**
 * 信息异动记录 Service 接口
 *
 * @author AKai
 */
public interface StudentChangeLogService {

    /**
     * 创建信息异动记录
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    String createStudentChangeLog(@Valid StudentChangeLogCreateReqVO createReqVO);

    /**
     * 更新信息异动记录
     *
     * @param updateReqVO 更新信息
     */
    void updateStudentChangeLog(@Valid StudentChangeLogUpdateReqVO updateReqVO);

    /**
     * 删除信息异动记录
     *
     * @param id 编号
     */
    void deleteStudentChangeLog(String id);

    /**
     * 获得信息异动记录
     *
     * @param id 编号
     * @return 信息异动记录
     */
    StudentChangeLogDO getStudentChangeLog(String id);

    /**
     * 获得信息异动记录列表
     *
     * @param ids 编号
     * @return 信息异动记录列表
     */
    List<StudentChangeLogDO> getStudentChangeLogList(Collection<String> ids);

    /**
     * 获得信息异动记录分页
     *
     * @param pageReqVO 分页查询
     * @return 信息异动记录分页
     */
    PageResult<StudentChangeLogDO> getStudentChangeLogPage(StudentChangeLogPageReqVO pageReqVO);

    /**
     * 获得信息异动记录列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 信息异动记录列表
     */
    List<StudentChangeLogDO> getStudentChangeLogList(StudentChangeLogExportReqVO exportReqVO);

}
